Contents

Title and Copyright Information

Preface

• Intended Audience
• Purpose of the Document
• Documentation Accessibility
• Related Documents
• Conventions

Part I Getting Started

1 Procuring Software

• Releases Available for Enterprise Manager Cloud Control
• Procuring Enterprise Manager Cloud Control Software
  • How Do You Access the Software from DVD?
    • Accessing Software from DVD
    • Setting Mount Point for DVD
  • How Do You Procure the Software from Oracle Technology Network?
    • Downloading Software
    • Verifying File Size
    • Extracting Contents
    • Verifying Software Release Description
    • Verifying Platform Information
• Procuring Oracle Management Agent Software

2 Understanding the Basics

• Understanding Installation Basics
  • What Different Installation Modes Can You Use?
  • What Is Enterprise Manager Cloud Control Installation Wizard?
  • What Installation Types Are Offered by the Installation Wizard?
    • Create a New Enterprise Manager System
    • Upgrade an Existing Enterprise Manager System
    • Install Software Only
  • What Is Oracle Configuration Manager?
    • Manually Collecting and Uploading Configuration Information
    • Enabling Oracle Configuration Manager After Installing Enterprise Manager Cloud Control
  • What Are Software Updates?
    • What Is a Software Update?
    • How Does the Software Update Feature Work?
    • What Types of Software Updates Are Downloaded and Applied?
    • How Can I Find Out What Bugs Have Been Fixed by the Software Updates?
    • How Can You Download the Software Updates?
    • Can I Download and Apply These Patches After Installation or Upgrade?
    • How Can You Identify What Patches Have Been Applied?
  • What is a Deployment Size?
  • What Is Add Host Target Wizard?
  • What Is Add Management Service Deployment Procedure?
  • What Ports Are Used for Installation?
    • What Default Ports Are Used?
    • How Can You Customize Ports?
    • What Precautions You Must Take While Customizing Port Numbers?
  • What Data Files Are Created While Configuring Oracle Management Repository?
  • How Do You Delete Data Files?
• Understanding Oracle WebLogic Server Requirement
  • How Do I Verify Whether Oracle WebLogic Server Is Installed?
  • Is Oracle WebLogic Server Cluster Supported?
  • If Oracle WebLogic Server Already Exists, Is the Existing Domain Used?
  • When and Why Do You Need Oracle WebLogic Server Credentials?
  • When and Why Do You Need Node Manager Credentials?
  • How Do You Find Admin Server Port After Installing Enterprise Manager?
  • How Do You Verify Whether Admin Server Is Running?
  • How Do You Start Admin Server?
• Understanding Installation Directories
  • What Is Oracle Inventory Directory?
  • What Is Oracle Middleware Home?
  • What Is Oracle Management Service Instance Base Location?
  • What Is Oracle Home?
  • What Is Agent Base Directory?
  • What is Agent Instance Directory?
  • What Is /TMP C:\Temp Directory Used For?
• Understanding Configuration Assistants
  • What Are Configuration Assistants?
  • What Configuration Assistants Are Run by the Installation Wizard?
    • Configuration Assistants Run While Installing a New Enterprise Manager
    • Configuration Assistants Run While Upgrading an Existing Enterprise Manager
    • Configuration Assistants Run While Upgrading an Additional Oracle Management Service
  • What Do You Do When Configuration Assistants Fail?
• Understanding Prerequisite Checks
  • What Prerequisite Checks Are Run by Default?
  • How Can You Run Prerequisite Checks in Standalone Mode?
• Understanding Limitations of Enterprise Manager Cloud Control
  • Can You Access Unlicensed Components?
  • What Are the Limitations with DHCP-Enabled Machines?
• Understanding Startup Scripts
• Understanding Other Miscellaneous Concepts
  • What Is a Host List File?
  • What Scripts Are Run During the Installation Process?

Part II Installing Enterprise Manager System

3 Installing Enterprise Manager System in Silent Mode

• Overview
• Before You Begin
• Prerequisites
• Installation Procedure
  • Installing Enterprise Manager
  • Using Advanced Installer Options
  • Understanding the Limitations
  • Editing Response File for Installing Software
• After You Install

4 Installing Enterprise Manager Software Now and Configuring Later

• Overview
• Before You Begin
• Prerequisites
• Installation Procedure
  • Installing in Graphical Mode
    • Installing Software
      • Using Advanced Installer Options
    • Running Root Script
    • Configure Software
      • Using Advanced Script Options
    • Performing Post-Configuration Tasks
  • Installing in Silent Mode
    • Installing Software
      • Editing Response File for Installing Software
    • Running Root Script
    • Configuring Software
      • Editing Response File for Configuring Software
    • Performing Post-Configuration Tasks

Part III Installing Additional Oracle Management Service

5 Installing Additional Oracle Management Service in Silent Mode

Part IV Installing Oracle Management Agent

6 Installing Oracle Management Agent in Silent Mode

• Overview
• Before You Begin
• Prerequisites
• Installation Procedure
  • Installing a Management Agent Using the AgentPull Script
    • Acquire the Management Agent Software
    • Install the Management Agent Using the AgentPull Script
  • Installing a Management Agent Using the agentDeploy Script
    • Using EM CLI from the Remote Destination Host
      • Acquire the Management Agent Software and Download it onto the Destination Host Using EM CLI
      • Install the Management Agent Using the agentDeploy Script
    • Using EM CLI from the OMS Host
      • Acquire the Management Agent Software and Download it onto the OMS Host Using EM CLI
      • Transfer the Management Agent Software to the Destination Host
      • Install the Management Agent Using the agentDeploy Script
  • Installing a Management Agent Using the RPM File
    • Acquire the Management Agent Software and Download the RPM File onto the OMS Host
    • Transfer the RPM File to the Destination Host
    • Install the Management Agent Using the RPM File
  • Creating a Response File for Installing Using AgentPull Script
  • Using a Response File for Installing Using agentDeploy Script
  • Creating a Response File for Installing Using an RPM File
  • Understanding the Options Supported by the AgentPull Script
  • Understanding the Options Supported by the agentDeploy Script
  • Understanding the Contents of the Downloaded Management Agent Software
  • Understanding the Contents of the Management Agent RPM File
• After You Install

7 Cloning Oracle Management Agent

• Overview
• Before You Begin
• Prerequisites
• Cloning Procedure
  • Cloning in Graphical Mode
    • Supported Additional Parameters
    • Format of Host List File
  • Cloning in Silent Mode
    • Setting Environment Variables for Cloning Agent Using ZIP File
• After You Clone

8 Installing Shared Agent

• Overview
• Before You Begin
• Prerequisites
• Installation Procedure
  • Installing in Graphical Mode
    • Supported Additional Parameters
  • Installing in Silent Mode
    • Creating a Response File
• After You Install

9 Installing Oracle Management Agent Software Now and Configuring Later

• Overview
• Before You Begin
• Prerequisites
• Installation Procedure
• Configuration Procedure
• After You Install

Part V Advanced Installation and Configuration

10 Performing Additional Configuration Tasks

• Understanding Default and Custom Data Collections
  • How Enterprise Manager Stores Default Collection Information
• Enabling Multi-Inventory Support for Configuration Management
  • AGENT_HOME Versus AGENT_STATE Directories
• Manually Configuring a Database Target for Complete Monitoring
• Modifying the Default Login Timeout Value
• Configuring Clusters and Cluster Databases in Cloud Control
  • Configuring Cluster Databases
  • Discovering Instances Added to the Cluster Database
    • Troubleshooting
• Collecting Client Configurations
  • Configuring the Client System Analyzer
    • Client System Analyzer in Oracle Cloud Control
    • Deploying Client System Analyzer Independently
  • Configuration Parameters
    • Associating the Parameters with an Application
  • Rules
  • Customization
  • CSA Deployment Examples
    • Using Multiple Collection Tags
    • Privilege Model for Viewing Client Configurations
    • Using the Customization API Example
    • Using the CSA Servlet Filter Example
    • Sample Deployments
      • Example 1: Helpdesk
      • Example 2: Inventory
      • Example 3: Problem Detection
• Configuring Privilege Delegation Providers
  • Creating a Privilege Delegation Setting
    • Creating a Sudo Setting Using EM CLI
    • Creating a PowerBroker Setting Using EM CLI
  • Applying Privilege Delegation Settings
    • Applying Settings to Host Targets Using EM CLI
    • Applying Settings to a Composite Target
  • Disabling Host Privilege Delegation Provider Settings Using EM CLI
  • Sudo Configuration: Sudoers File
  • Configuring Privilege Delegation Providers Using Cloud Control Console
    • Configuring Sudo Settings For a Host Using Enterprise Manager Cloud Control Console
    • Configuring PowerBroker Settings For a Host Using the Cloud Control Console
    • Applying Settings to Multiple Host Targets Using the Cloud Control Console
    • Disabling Host Privilege Delegation Provider Settings For One or More Hosts Using Cloud Control Console

11 Configuring Enterprise Manager for Firewalls

• Firewall Configuration Considerations
  • Enabling ICMP Echo Requests on Firewalls
• Overview of Enterprise Manager Components and Ports
  • Viewing a Summary of the Ports Assigned During Installation
  • Default Port Assignments for Enterprise Manager Components
• Firewall Configurations for Enterprise Management Components
  • Firewalls Between Your Browser and the Enterprise Manager Console
  • Configuring the Management Agent on a Host Protected by a Firewall
    • Configuring the Management Agent to Use a Proxy Server
    • Configuring the Firewall to Allow Incoming Communication From the Management Service
  • Configuring the OMS on a Host Protected by a Firewall
    • Configuring the OMS to Use a Proxy Server to Communicate with Management Agents
    • Configuring the Firewall to Allow Incoming Management Data From the Management Agents
    • Enabling OMS to Access My Oracle Support
    • About the dontProxyfor Property
  • Firewalls Between the OMS and the Management Repository
  • Firewalls Between Enterprise Manager and a Managed Database Target
  • Firewalls Used with Multiple OMS Instances
  • Configuring Firewalls to Allow ICMP and UDP Traffic for Beacons

12 Sizing Your Enterprise Manager Deployment

• Overview of Oracle Enterprise Manager Cloud Control Architecture
• Enterprise Manager Cloud Control Sizing
  • Overview of Sizing Guidelines
    • Hardware Information
    • Sizing Specifications
    • Sizing for Upgraded Installs
    • Minimum Hardware Requirements
    • Network Topology Considerations
  • Software Configurations
    • Small Configuration
    • Medium Configuration
    • Large Configuration
    • Repository Tablespace Sizing
  • Additional Configurations
    • Large Concurrent UI Load
    • BI Publisher Configuration
• Enterprise Manager Cloud Control Performance Methodology
  • Step 1: Choosing a Starting Platform Cloud Control Deployment
  • Step 2: Periodically Evaluating the Vital Signs of Your Site
  • Step 3: Using DBA and Enterprise Manager Tasks To Eliminate Bottlenecks
    • Offline Monthly Tasks
  • Step 4: Eliminating Bottlenecks Through Tuning
    • High CPU Utilization
    • Loader Vital Signs
    • Rollup Vital Signs
    • Rollup Process
    • Job, Notification, and Alert Vital Signs
    • I/O Vital Signs
    • About the Oracle Enterprise Manager Performance Page
    • Determining the Optimum Number of Middle Tier OMS Servers
  • Step 5: Extrapolating Linearly Into the Future for Sizing Requirements
  • Using Returning Query Safeguards to Improve Performance
• Overview of Repository and Sizing Requirements for Fusion Middleware Monitoring
  • ADP Monitoring
  • JVMD Monitoring

13 Installing ADP with Advanced Installation Options

• Application Dependency and Performance Architecture
• Before you Begin
• Prerequisites
• Installation Procedure
  • Deploying ADP Engines
    • Deploying ADP Engine on a Remote Host
      • Meet the Prerequisites
      • Deploy ADP Engine on the Remote Host
    • Deploying ADP Engine Manually Using ApmEngineSetup.pl
  • Deploying ADP Agents Manually Using deploy_adpagent.pl
• After You Install
  • Verifying ADP Engine and ADP Agent Installation
  • Configuring Oracle SOA Suite for Secure Connectivity
  • Configuring Oracle WebLogic Server or Oracle WebLogic Portal (WLP) for Secure Connectivity
  • Importing a Certificate into ADP Engine's Keystore
  • Configuring ADP Agent When WebLogic Is Installed As a Windows Service

14 Installing JVMD with Advanced Install Options

• JVMD Architecture
• Before you Begin
• Prerequisites
• Installation Procedure
  • Deploying JVMD Engine
    • Deploying JVMD Engine on a Remote Host
      • Meet the Prerequisites
      • Deploy JVMD Engine on the Remote Host
    • Deploying JVMD Engine Manually
      • Download jvmd.zip
      • Deploy JVMD Engine
    • Deploying JVMD Engine Manually Using ApmEngineSetup.pl
  • Deploying JVMD Agents
    • Deploying JVMD Agents Manually
      • Download javadiagnosticagent.ear or jamagent.war
      • Deploy JVMD Agent
    • Deploying JVMD Agents Manually Using deploy_jvmdagent.pl
    • Deploying JVMD Agents for High Availability
      • Deploying JVMD Agents for High Availability Using the Application Performance Management Page
      • Deploying JVMD Agents for High Availability Manually
    • Deploying JVMD Database Agent
    • Connecting JVMD Agent to the JVMD Engine Secure Port
• After You Install

15 Integrating BI Publisher with Enterprise Manager

• Overview
  • Limitations
  • Downloading Oracle BI Publisher
• BI Publisher Installation and Integration with Enterprise Manager 12c
  • Enterprise Manager and BI Publisher Inventory
  • Installing Enterprise Manager and Required Infrastructure
    • Installing BI EE Using Software-only Install
    • Integrating BI Publisher with Enterprise Manager using the configureBIP Script
      • Integrating BI Publisher with Enterprise Manager using the configureBIP Script in Normal Mode
      • Integrating BI Publisher with Enterprise Manager Using the configureBIP Script in Upgrade Mode
• Verifying Integration of BI Publisher with Enterprise Manager
• Allowing Access to BI Publisher for Enterprise Manager Administrators
  • Enterprise Manager Authentication Security Model
  • BI Publisher security model
  • BI Publisher Permissions
  • BI Publisher OPSS Application Roles
  • Authenticating and limiting access BI Publisher features
• Limiting access to BI Publisher features
  • Granting BI Publisher OPSS Application Roles to Enterprise Manager Administrators in Repository-Based Authentication Mode Using wlst
  • Propagation Time for Changes to OPSS
• Allowing Access to BI Publisher for Enterprise Manager Administrators in an underlying LDAP Authentication security model environment
  • Mapping LDAP Groups to BI Publisher OPSS Application Roles
• Securing BI Publisher with a Secure Socket Layer (SSL) Certificate
• BI Publisher Administration
• Post-Upgrade Steps to take after upgrading to BI Publisher to 11.1.1.6.0
• EMBIP* Roles: Granting Access to Folders and Catalog Objects
• Access to Enterprise Manager Repository
• Troubleshooting
  • Rerunning configureBIP
  • BI Publisher Log File Locations
    • configureBIP Log Files
    • Enterprise Manager BI Publisher Tree and EM CLI Log File Output
    • BI Publisher Runtime
  • Additional Troubleshooting
  • Redeploying All Enterprise Manager-Supplied BI Publisher Reports
• Managing Enterprise Manager - BI Publisher Connection Credentials
• Managing the BI Publisher Server
• Configuring BI Publisher behind a Load-Balancer

16 Running OMS in Console-Only Mode

Part VI Deinstallation

17 Deinstalling Enterprise Manager (Single and Multi-OMS Environments)

• Deinstalling Enterprise Manager
  • Prerequisites for Deinstalling Only the OMS and Retaining the Management Repository
  • Prerequisites for Deinstalling the Entire Enterprise Manager System
  • Deinstallation Procedure
    • Deinstalling in Graphical Mode
    • Deinstalling in Silent Mode
  • After You Deinstall
• Deinstalling or Undeploying Only Plug-ins from the OMS
• Deleting OMS Entries from the Management Repository

18 Deinstalling Oracle Management Agent

• Deinstalling Oracle Management Agents
  • Prerequisites
  • Deinstallation Procedure
    • Deinstalling Oracle Management Agent in Graphical Mode
    • Deinstalling Oracle Management Agent in Silent Mode
      • Deinstalling in Silent Mode Using the Installer
      • Deinstalling in Silent Mode Using AgentDeinstall.pl Script
    • Deinstalling Shared Agent
    • Deinstalling Oracle Management Agent Installed Using an RPM File
  • After You Deinstall
• Deinstalling or Undeploying Only Plug-ins from the Oracle Management Agent

19 Deinstalling ADP and JVMD

• Deinstallation Procedure for ADP
  • Removing ADP Engine
    • Removing ADP Engine Using Application Performance Management Page
    • Removing ADP Engine Manually
    • Removing ADP Engine Manually Using ApmEngineSetup.pl
  • Removing ADP Agents
    • Removing ADP Agents Using Application Performance Management Page
    • Removing ADP Agents Deployed to Targets Manually
• Deinstallation Procedure for JVMD
  • Removing JVMD Engine
    • Removing JVMD Engine Using Application Performance Management Page
    • Removing JVMD Engine Manually
    • Removing JVMD Engine Manually Using ApmEngineSetup.pl
  • Removing JVMD Agents
    • Removing JVMD Agents Using Application Performance Management Page
    • Removing JVMD Agents Deployed to Targets Manually

20 Removing Standby Oracle Management Services

• Removing Additional Standby OMS Instances
• Removing the First Standby OMS

Part VII Appendixes

A Understanding the Enterprise Manager Directory Structure

• Understanding the Enterprise Manager Directories Installed with Oracle Enterprise Manager Cloud Control 12c
  • About the Oracle Management Service Home Directory
  • About the Oracle Management Agent Home (AGENT_HOME) Directory
  • About Business Intelligence Publisher Home Directory
  • Summary of the Important Directories in the Oracle Management Service Home
• Understanding the Enterprise Manager Directories Installed with Management Service
• Understanding the Enterprise Manager Directories Installed with Management Agent
  • Summary of the Important Directories in the Oracle Management Agent Home
  • Understanding the Oracle Management Agent Directory Structure in Windows
• Identifying the Agent Instance Home When Using the emctl Command

B Installation and Configuration Log Files

• Enterprise Manager Cloud Control Installation Logs
  • Installation Logs
  • Configuration Logs
    • General Configuration Logs
    • Repository Configuration Logs
      • SYSMAN Schema Operation Logs
      • EMPrereqKit Logs
      • MDS Schema Operation Logs
    • Secure Logs
    • Oracle Management Service Logs
• Add Host Log Files
  • Initialization Logs
  • Application Prerequisite Logs
  • System Prerequisite Logs
  • Agent Installation Logs
  • Other Add Host Logs
• Manual Management Agent Installation Logs
• Additional OMS Installation Logs

C Redirecting Oracle Management Agent to Another Oracle Management Service

• Prerequisites
• Procedure

D Applying One-Off Patches to Oracle Management Agents

• Saving Management Agent Patches to an OMS Host
• Verifying Patch Application After Management Agent Deployment or Upgrade

E Using RepManager Utility

• Overview
• Supported Actions and Commands

F Collecting OCM Data Using Oracle Harvester

• Oracle Harvester
  • Supported Targets in Oracle Harvester
  • Configuration Data Not Available in My Oracle Support
• Oracle Configuration Manager
• Additional Information
• Troubleshooting Configuration Data Collection Tools
  • Oracle Harvester Collection Fails If the state/upload/external Directory Is Missing
  • Oracle Configuration Manager Is Not Running
  • Configuration Data Not Available in My Oracle Support
  • Only a Subset of the Targets Is Collected by the Oracle Harvester

G Enabling Enterprise Manager Accessibility Features

• Enabling Enterprise Manager Accessibility Mode
• Setting uix-config.xml Flag
• Configuring web.xml File
• Verifying That Screen Reader Support Is Enabled

H Configuring Targets for Failover in Active/Passive Environments

• Target Relocation in Active/Passive Environments
• Installation and Configuration
  • Prerequisites
  • Configuration Steps
    • Discovering Targets
    • Deploying Plug-ins
• Failover Procedure
• Failback Procedure
• EM CLI relocate_targets Parameters
• Relocation Script
  • Relocation Script Example

I Troubleshooting

• Troubleshooting Configuration Assistant Failures
  • Plugins Prerequisite Check Configuration Assistant
  • Repository Configuration Assistant
  • Repository Out Of Box Configuration Assistant
  • MDS Schema Configuration Assistant
  • OMS Configuration Assistant
  • Plugins Deployment and Configuration Configuration Assistant
  • Start Oracle Management Service Configuration Assistant
  • Plugins Inventory Migration Configuration Assistant
  • Oracle Configuration Manager Repeater Configuration Assistant
  • OCM Configuration for OMS Configuration Assistant
  • Agent Configuration Assistant
  • Agent Upgrade Configuration Assistant
  • Repository Upgrade Configuration Assistant
  • Stopping APM Engines Configuration Assistant
  • Stop Admin Server Configuration Assistant
• Troubleshooting ADP and JVMD Failures
  • ADP Engine Name Conflict
  • Failure to Deploy ADP Agent On a Target
  • Failure to Deploy JVMD Agent On a Target
  • SSL Handshake Failure Agent Deployment Errors
  • Copying ADP Agent Zip or Javadiagnosticagent.ear Failure
• Troubleshooting Package-Related Issues
• Troubleshooting Deinstallation Failures
• Troubleshooting Management Agent Installation Failures

Index